package com.journal.book.service;

import com.journal.book.domain.PageVisit;
import java.util.List;

/**
 * 页面访问记录Service接口
 *
 * @author mobin
 * @date 2025-01-XX
 */
public interface IPageVisitService
{
    /**
     * 记录页面访问
     * 
     * @param pagePath 页面路径
     * @param pageName 页面名称（可选）
     * @param userIdentifier 用户唯一标识（可选）
     * @param ipAddress IP地址（可选）
     * @param location IP所在地区（可选）
     * @param brand 手机品牌（可选）
     * @param model 设备型号（可选）
     * @param osName 操作系统名称（可选）
     * @return 结果
     */
    public int recordPageVisit(String pagePath, String pageName, String userIdentifier, 
                               String ipAddress, String location, String brand, String model, String osName);

    /**
     * 查询页面访问记录
     *
     * @param id 页面访问记录主键
     * @return 页面访问记录
     */
    public PageVisit selectPageVisitById(Long id);

    /**
     * 查询页面访问记录列表
     *
     * @param pageVisit 页面访问记录
     * @return 页面访问记录集合
     */
    public List<PageVisit> selectPageVisitList(PageVisit pageVisit);

    /**
     * 新增页面访问记录
     *
     * @param pageVisit 页面访问记录
     * @return 结果
     */
    public int insertPageVisit(PageVisit pageVisit);

    /**
     * 修改页面访问记录
     *
     * @param pageVisit 页面访问记录
     * @return 结果
     */
    public int updatePageVisit(PageVisit pageVisit);

    /**
     * 批量删除页面访问记录
     *
     * @param ids 需要删除的页面访问记录主键集合
     * @return 结果
     */
    public int deletePageVisitByIds(Long[] ids);

    /**
     * 删除页面访问记录信息
     *
     * @param id 页面访问记录主键
     * @return 结果
     */
    public int deletePageVisitById(Long id);
}

